<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu197.htm">Previous Page</A> &#124; <A HREF="progu199.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXGPRAI"
HREF="progu097.htm#PToC_292">DXGetProductArrayInfo</A></H3>
<A NAME="IDX1788"></A>
<A NAME="IDX1789"></A>
<P><STRONG>Function</STRONG>
<P>
Returns the number of terms and the terms of a Product Array.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
ProductArray DXGetProductArrayInfo(ProductArray a, int *n, Array *terms)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
If <TT><STRONG>n</STRONG></TT> is not
<TT><STRONG>NULL</STRONG></TT>,
this routine returns in
<TT><STRONG>
*n
</STRONG></TT>
the number of
terms in the product
<TT><STRONG>a</STRONG></TT>.  If
<TT><STRONG>
terms
</STRONG></TT>
is not
<TT><STRONG>NULL</STRONG></TT>,
it returns in
<TT><STRONG>
*terms
</STRONG></TT>
the terms of the product.
<P>
Product Arrays provide a compact method for specifying regular
and partially regular
"positions" components.  In their simplest form,
a regular n-dimensional grid may be defined by combining n
Regular Arrays, each of which specifies a set of points along
some n-dimensional delta vector.  Partially regular
"positions"
components may be specified compactly by combining regular and
irregular terms.
<P>
<TT><STRONG>
DXGetProductArrayInfo
</STRONG></TT>
allows access to the constituent terms of the Product Array and is
useful in cases where the terms may be handled independently, or
when knowledge of the separate terms make it possible to
process the Product Array without
expansion.  Array handles also provide
a mechanism to access individual elements of a Product Array without
expansion.
<P><STRONG>Return Value</STRONG>
<P>
Returns <TT><STRONG>a</STRONG></TT> or returns <TT><STRONG>NULL</STRONG></TT>
and sets an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu124.htm#HDRDXCAH">DXCreateArrayHandle</A>,
<A HREF="progu258.htm#HDRDXNPAV">DXNewProductArray, DXNewProductArrayV</A>,
<A HREF="progu279.htm#HDRDXQGP">DXQueryGridPositions</A>
</STRONG></TT>
<P>
<A HREF="progu046.htm#HDRPTAS">"Product Arrays"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu197.htm">Previous Page</A> &#124; <A HREF="progu199.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
